<!DOCTYPE html>
<html lang="zh-Hans">
<head>
  <meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=2">
<meta name="theme-color" content="#222">
<meta name="generator" content="Hexo 4.2.1">
  <link rel="apple-touch-icon" sizes="180x180" href="/images/apple-touch-icon-next.png">
  <link rel="icon" type="image/png" sizes="32x32" href="/images/favicon-32x32-next.png">
  <link rel="icon" type="image/png" sizes="16x16" href="/images/favicon-16x16-next.png">
  <link rel="mask-icon" href="/images/logo.svg" color="#222">

<link rel="stylesheet" href="/css/main.css">


<link rel="stylesheet" href="/lib/font-awesome/css/all.min.css">
  <link rel="stylesheet" href="/lib/pace/pace-theme-minimal.min.css">
  <script src="/lib/pace/pace.min.js"></script>

<script id="hexo-configurations">
    var NexT = window.NexT || {};
    var CONFIG = {"hostname":"sophimp.gitee.io","root":"/","scheme":"Pisces","version":"7.8.0","exturl":false,"sidebar":{"position":"left","display":"post","padding":18,"offset":12,"onmobile":false},"copycode":{"enable":false,"show_result":false,"style":null},"back2top":{"enable":true,"sidebar":false,"scrollpercent":true},"bookmark":{"enable":false,"color":"#222","save":"auto"},"fancybox":false,"mediumzoom":false,"lazyload":false,"pangu":false,"comments":{"style":"tabs","active":null,"storage":true,"lazyload":false,"nav":null},"algolia":{"hits":{"per_page":10},"labels":{"input_placeholder":"Search for Posts","hits_empty":"We didn't find any results for the search: ${query}","hits_stats":"${hits} results found in ${time} ms"}},"localsearch":{"enable":false,"trigger":"auto","top_n_per_article":1,"unescape":false,"preload":false},"motion":{"enable":true,"async":false,"transition":{"post_block":"fadeIn","post_header":"slideDownIn","post_body":"slideDownIn","coll_header":"slideLeftIn","sidebar":"slideUpIn"}}};
  </script>

  <meta name="description" content="yang mdoel 是一种建模语言, 为什么要使用yang, 相比于netconf的xml形式，yang有什么优缺点，怎么与netconf结合的, 对于c语言实现的libyang库又该如何使用呢？怎么移植到c sharp中来呢？">
<meta property="og:type" content="article">
<meta property="og:title" content="nms-yang model">
<meta property="og:url" content="http://sophimp.gitee.io/2021/01/06/nms/nms-yang/index.html">
<meta property="og:site_name" content="Sophimp&#39;s Space">
<meta property="og:description" content="yang mdoel 是一种建模语言, 为什么要使用yang, 相比于netconf的xml形式，yang有什么优缺点，怎么与netconf结合的, 对于c语言实现的libyang库又该如何使用呢？怎么移植到c sharp中来呢？">
<meta property="article:published_time" content="2021-01-06T02:03:57.000Z">
<meta property="article:modified_time" content="2021-03-15T03:49:47.938Z">
<meta property="article:author" content="Sophimp">
<meta property="article:tag" content="nms">
<meta property="article:tag" content="yang">
<meta name="twitter:card" content="summary">

<link rel="canonical" href="http://sophimp.gitee.io/2021/01/06/nms/nms-yang/">


<script id="page-configurations">
  // https://hexo.io/docs/variables.html
  CONFIG.page = {
    sidebar: "",
    isHome : false,
    isPost : true,
    lang   : 'zh-Hans'
  };
</script>

  <title>nms-yang model | Sophimp's Space</title>
  






  <noscript>
  <style>
  .use-motion .brand,
  .use-motion .menu-item,
  .sidebar-inner,
  .use-motion .post-block,
  .use-motion .pagination,
  .use-motion .comments,
  .use-motion .post-header,
  .use-motion .post-body,
  .use-motion .collection-header { opacity: initial; }

  .use-motion .site-title,
  .use-motion .site-subtitle {
    opacity: initial;
    top: initial;
  }

  .use-motion .logo-line-before i { left: initial; }
  .use-motion .logo-line-after i { right: initial; }
  </style>
</noscript>

</head>

<body itemscope itemtype="http://schema.org/WebPage">
  <div class="container use-motion">
    <div class="headband"></div>

	
	<script type="text/javascript" src="//cdn.bootcss.com/canvas-nest.js/1.0.0/canvas-nest.min.js"></script>
	

    <header class="header" itemscope itemtype="http://schema.org/WPHeader">
      <div class="header-inner"><div class="site-brand-container">
  <div class="site-nav-toggle">
    <div class="toggle" aria-label="Toggle navigation bar">
      <span class="toggle-line toggle-line-first"></span>
      <span class="toggle-line toggle-line-middle"></span>
      <span class="toggle-line toggle-line-last"></span>
    </div>
  </div>

  <div class="site-meta">

    <a href="/" class="brand" rel="start">
      <span class="logo-line-before"><i></i></span>
      <h1 class="site-title">Sophimp's Space</h1>
      <span class="logo-line-after"><i></i></span>
    </a>
      <p class="site-subtitle" itemprop="description">coding & thinking</p>
  </div>

  <div class="site-nav-right">
    <div class="toggle popup-trigger">
    </div>
  </div>
</div>




<nav class="site-nav">
  <ul id="menu" class="main-menu menu">
        <li class="menu-item menu-item-home">

    <a href="/" rel="section"><i class="fa fa-home fa-fw"></i>Home</a>

  </li>
        <li class="menu-item menu-item-archives">

    <a href="/archives/" rel="section"><i class="fa fa-archive fa-fw"></i>Archives</a>

  </li>
  </ul>
</nav>




</div>
    </header>

    
  <div class="back-to-top">
    <i class="fa fa-arrow-up"></i>
    <span>0%</span>
  </div>
  <div class="reading-progress-bar"></div>

  <a href="https://github.com/sophimp" class="github-corner" title="Follow me on GitHub" aria-label="Follow me on GitHub" rel="noopener" target="_blank"><svg width="80" height="80" viewBox="0 0 250 250" aria-hidden="true"><path d="M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z"></path><path d="M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2" fill="currentColor" style="transform-origin: 130px 106px;" class="octo-arm"></path><path d="M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z" fill="currentColor" class="octo-body"></path></svg></a>


    <main class="main">
      <div class="main-inner">
        <div class="content-wrap">
          

          <div class="content post posts-expand">
            

    
  
  
  <article itemscope itemtype="http://schema.org/Article" class="post-block" lang="zh-Hans">
    <link itemprop="mainEntityOfPage" href="http://sophimp.gitee.io/2021/01/06/nms/nms-yang/">

    <span hidden itemprop="author" itemscope itemtype="http://schema.org/Person">
      <meta itemprop="image" content="/images/avatar.png">
      <meta itemprop="name" content="Sophimp">
      <meta itemprop="description" content="A dream begin">
    </span>

    <span hidden itemprop="publisher" itemscope itemtype="http://schema.org/Organization">
      <meta itemprop="name" content="Sophimp's Space">
    </span>
      <header class="post-header">
        <h1 class="post-title" itemprop="name headline">
          nms-yang model
        </h1>

        <div class="post-meta">
            <span class="post-meta-item">
              <span class="post-meta-item-icon">
                <i class="far fa-calendar"></i>
              </span>
              <span class="post-meta-item-text">Posted on</span>

              <time title="Created: 2021-01-06 10:03:57" itemprop="dateCreated datePublished" datetime="2021-01-06T10:03:57+08:00">2021-01-06</time>
            </span>
              <span class="post-meta-item">
                <span class="post-meta-item-icon">
                  <i class="far fa-calendar-check"></i>
                </span>
                <span class="post-meta-item-text">Edited on</span>
                <time title="Modified: 2021-03-15 11:49:47" itemprop="dateModified" datetime="2021-03-15T11:49:47+08:00">2021-03-15</time>
              </span>
            <span class="post-meta-item">
              <span class="post-meta-item-icon">
                <i class="far fa-folder"></i>
              </span>
              <span class="post-meta-item-text">In</span>
                <span itemprop="about" itemscope itemtype="http://schema.org/Thing">
                  <a href="/categories/nms/" itemprop="url" rel="index"><span itemprop="name">nms</span></a>
                </span>
            </span>

          
            <span class="post-meta-item" title="Views" id="busuanzi_container_page_pv" style="display: none;">
              <span class="post-meta-item-icon">
                <i class="fa fa-eye"></i>
              </span>
              <span class="post-meta-item-text">Views: </span>
              <span id="busuanzi_value_page_pv"></span>
            </span>
            <div class="post-description">yang mdoel 是一种建模语言, 为什么要使用yang, 相比于netconf的xml形式，yang有什么优缺点，怎么与netconf结合的, 对于c语言实现的libyang库又该如何使用呢？怎么移植到c sharp中来呢？</div>

        </div>
      </header>

    
    
    
    <div class="post-body" itemprop="articleBody">

      
        <h3 id="libyang-概览"><a href="#libyang-概览" class="headerlink" title="libyang 概览"></a>libyang 概览</h3><p>是什么<br>yang 是数据建模语言， 实际数据传输的承载形式还是使用xml。<br>libyang库可以解析yang model, 用来定义xml的结构，校验xml的合法性, 解析xml的说明文档，也可以用来动态生成xml。</p>
<p>为什么<br>yang model 为程序提供了一致的操作数据的接口， 解决了配置读写困难的问题。<br>使用yang模型建模, 可以利用yang模型完成数据合法性的检查，保证风格一致性，不需要应用程序直接操作文件。</p>
<h3 id="标识符"><a href="#标识符" class="headerlink" title="标识符"></a>标识符</h3><p> The module’s Substatements</p>
<p> +————–+———+————-+<br> | substatement | section | cardinality |<br> +————–+———+————-+<br> | anyxml       | 7.10    | 0..n        |<br> | augment      | 7.15    | 0..n        |<br> | choice       | 7.9     | 0..n        |<br> | contact      | 7.1.8   | 0..1        |<br> | container    | 7.5     | 0..n        |<br> | description  | 7.19.3  | 0..1        |<br> | deviation    | 7.18.3  | 0..n        |<br> | extension    | 7.17    | 0..n        |<br> | feature      | 7.18.1  | 0..n        |<br> | grouping     | 7.11    | 0..n        |<br> | identity     | 7.16    | 0..n        |<br> | import       | 7.1.5   | 0..n        |<br> | include      | 7.1.6   | 0..n        |<br> | leaf         | 7.6     | 0..n        |<br> | leaf-list    | 7.7     | 0..n        |<br> | list         | 7.8     | 0..n        |<br> | namespace    | 7.1.3   | 1           |<br> | notification | 7.14    | 0..n        |<br> | organization | 7.1.7   | 0..1        |<br> | prefix       | 7.1.4   | 1           |<br> | reference    | 7.19.4  | 0..1        |<br> | revision     | 7.1.9   | 0..n        |<br> | rpc          | 7.13    | 0..n        |<br> | typedef      | 7.3     | 0..n        |<br> | uses         | 7.12    | 0..n        |<br> | yang-version | 7.1.2   | 0..1        |<br> +————–+———+————-+</p>
<p>argument</p>
<p>notification<br>    属于netconf协议的，是单独放在一个xml的吗？<br>    如何去识别属于哪个接口呢？ 命名空间吗？ </p>
<pre><code>当notification定义为顶层节点时，编码为 Notification Event Notification, 通知名称的xml标签在最外层。
当notification定义为子节点时，notification 包含数据存储区中节点的节点层次结构。它必须包含从顶层到包含通知的列表或容器的所有容器和列表节点。最里面的容器或列表包含一个xml元素，名称为notification的名称</code></pre><p>identity<br>    用于定义新的全局唯一，抽象和无类型的身份。 identity唯一目的是表示它的名字，语义和存在。</p>
<p>extension<br>    extension语句 允许定义语言中的新语句, 可被其他模块导入和使用<br>    参数是一个标识符, 是扩展名的新关键字，后面必须眼着一个包含详细扩展信息的子语句块。<br>    目的是定义一个关键字，使用可以被其他模块导入和使用</p>
<pre><code>可选的argument 语句将一个字符串作为参数，该字符串是关键字参数的名称。如果不存在 argument语句，则关键字在使用是不需要参数。
这个参数在 YIN映射中使用， 取决于参数的 yin-element 语句，true 表示作为标签， false 表示作为属性。 默认为false</code></pre><p>feature<br>    用于定义一个机制, 通过将schma的部分标记为条件, 能过 if-feature 来引用<br>    除非netconf-server支持给定的特征方式，否则将忽略使用 if-feature 标记的节点。<br>    if-feature 使其父语句有条件，参数是feature 名称的布尔表达式,<br>    deviate, 定义了目标节点的服务器实现如何偏离其原始定义。参数是 not-supported, add, replace, delete之一。</p>
<p>config<br>    config 参数为字符串”true” 或 “false”, 为true, 代表配置，表示配置的数据节点是配置数据存储的一部分。 为false, 代表状态数据，表示状态数据不是配置数据存储的一部分。<br>    如果未指定config, 表示缺省值与父节点的config值相同， 如果父节点是一个case节点， 则该值与case节点的父节点选择节点相同。<br>    如果顶层节点没有config, 默认为true。 如果一个节点的 config 为true, 那么其了节点都不能将 config设置为true。</p>
<pre><code>status 声明，参数为字符串 &quot;current&quot;, &quot;deprecated&quot;, &quot;obsolote&quot; 之一。 默认为&quot;current&quot;
when 声明， 参数是一个 XPath表达式。</code></pre><p>rpc<br>    netconf的rpc定义, rpc, rpc-reply</p>
<p>action</p>
<p>choice<br>    choice 和 case 节点在xml中都不可见。 </p>
<p>when</p>
<h3 id="语法"><a href="#语法" class="headerlink" title="语法"></a>语法</h3><p>built-in type 内置类型<br>+———————+————————————-+<br>| Name                | Description                         |<br>+———————+————————————-+<br>| binary              | Any binary data                     |<br>| bits                | A set of bits or flags              |<br>| boolean             | “true” or “false”                   |<br>| decimal64           | 64-bit signed decimal number        |<br>| empty               | A leaf that does not have any value |<br>| enumeration         | Enumerated strings                  |<br>| identityref         | A reference to an abstract identity |<br>| instance-identifier | References a data tree node         |<br>| int8                | 8-bit signed integer                |<br>| int16               | 16-bit signed integer               |<br>| int32               | 32-bit signed integer               |<br>| int64               | 64-bit signed integer               |<br>| leafref             | A reference to a leaf instance      |<br>| string              | Human-readable string               |<br>| uint8               | 8-bit unsigned integer              |<br>| uint16              | 16-bit unsigned integer             |<br>| uint32              | 32-bit unsigned integer             |<br>| uint64              | 64-bit unsigned integer             |<br>| union               | Choice of member types              |<br>+———————+————————————-+<br>typedef 定义结构体类型</p>
<ul>
<li>引用</li>
</ul>
<p>在不带引号的字符串中，每个字符都被保留</p>
<h3 id="总结"><a href="#总结" class="headerlink" title="总结"></a>总结</h3><p>libyang 库暂时没有必要移植到c#端，根据yang model, 人工写出xml结构，然后在c#端实现 xml to object 的serial 与 deserial 的操作即可。</p>
<p>看了rfc6020 相关的资料文档，暂时了解到model statement就够实例化出 xml了。<br>由于是公司的临时项目，纯当开开眼界参与一下，不继续深入了。</p>
<h3 id="资料文档"><a href="#资料文档" class="headerlink" title="资料文档"></a>资料文档</h3><p><a href="https://tools.ietf.org/html/rfc6020#page-169" target="_blank" rel="noopener">yang rfc6020</a><br><a href="https://blog.csdn.net/ohohoohoho/article/details/52129076" target="_blank" rel="noopener">yang rfc6020 中文机翻</a><br><a href="https://www.bookstack.cn/read/rfc7950-zh/README.md" target="_blank" rel="noopener">yang 1.1 数据建模语言 翻译</a><br><a href="https://www.cnblogs.com/guogangj/p/7489218.html" target="_blank" rel="noopener">xml to c# class serial and deserial</a><br><a href="https://tools.ietf.org/html/rfc5277" target="_blank" rel="noopener">netconf event notifications rfc5277</a></p>

    </div>

    
    
    

      <footer class="post-footer">
          <div class="post-tags">
              <a href="/tags/nms/" rel="tag"># nms</a>
              <a href="/tags/yang/" rel="tag"># yang</a>
          </div>

        


        
    <div class="post-nav">
      <div class="post-nav-item">
    <a href="/2021/01/06/nms/nms-netconf/" rel="prev" title="netconf协议">
      <i class="fa fa-chevron-left"></i> netconf协议
    </a></div>
      <div class="post-nav-item">
    <a href="/2021/01/08/android/volte_vulnerability_zh/" rel="next" title="Volte漏洞分析(译)">
      Volte漏洞分析(译) <i class="fa fa-chevron-right"></i>
    </a></div>
    </div>
      </footer>
    
  </article>
  
  
  



          </div>
          

<script>
  window.addEventListener('tabs:register', () => {
    let { activeClass } = CONFIG.comments;
    if (CONFIG.comments.storage) {
      activeClass = localStorage.getItem('comments_active') || activeClass;
    }
    if (activeClass) {
      let activeTab = document.querySelector(`a[href="#comment-${activeClass}"]`);
      if (activeTab) {
        activeTab.click();
      }
    }
  });
  if (CONFIG.comments.storage) {
    window.addEventListener('tabs:click', event => {
      if (!event.target.matches('.tabs-comment .tab-content .tab-pane')) return;
      let commentClass = event.target.classList[1];
      localStorage.setItem('comments_active', commentClass);
    });
  }
</script>

        </div>
          
  
  <div class="toggle sidebar-toggle">
    <span class="toggle-line toggle-line-first"></span>
    <span class="toggle-line toggle-line-middle"></span>
    <span class="toggle-line toggle-line-last"></span>
  </div>

  <aside class="sidebar">
    <div class="sidebar-inner">

      <ul class="sidebar-nav motion-element">
        <li class="sidebar-nav-toc">
          Table of Contents
        </li>
        <li class="sidebar-nav-overview">
          Overview
        </li>
      </ul>

      <!--noindex-->
      <div class="post-toc-wrap sidebar-panel">
          <div class="post-toc motion-element"><ol class="nav"><li class="nav-item nav-level-3"><a class="nav-link" href="#libyang-概览"><span class="nav-number">1.</span> <span class="nav-text">libyang 概览</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#标识符"><span class="nav-number">2.</span> <span class="nav-text">标识符</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#语法"><span class="nav-number">3.</span> <span class="nav-text">语法</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#总结"><span class="nav-number">4.</span> <span class="nav-text">总结</span></a></li><li class="nav-item nav-level-3"><a class="nav-link" href="#资料文档"><span class="nav-number">5.</span> <span class="nav-text">资料文档</span></a></li></ol></div>
      </div>
      <!--/noindex-->

      <div class="site-overview-wrap sidebar-panel">
        <div class="site-author motion-element" itemprop="author" itemscope itemtype="http://schema.org/Person">
    <img class="site-author-image" itemprop="image" alt="Sophimp"
      src="/images/avatar.png">
  <p class="site-author-name" itemprop="name">Sophimp</p>
  <div class="site-description" itemprop="description">A dream begin</div>
</div>
<div class="site-state-wrap motion-element">
  <nav class="site-state">
      <div class="site-state-item site-state-posts">
          <a href="/archives/">
        
          <span class="site-state-item-count">86</span>
          <span class="site-state-item-name">posts</span>
        </a>
      </div>
      <div class="site-state-item site-state-categories">
            <a href="/categories/">
        <span class="site-state-item-count">19</span>
        <span class="site-state-item-name">categories</span></a>
      </div>
      <div class="site-state-item site-state-tags">
            <a href="/tags/">
        <span class="site-state-item-count">89</span>
        <span class="site-state-item-name">tags</span></a>
      </div>
  </nav>
</div>
  <div class="links-of-author motion-element">
      <span class="links-of-author-item">
        <a href="https://github.com/sophimp" title="GitHub → https:&#x2F;&#x2F;github.com&#x2F;sophimp" rel="noopener" target="_blank"><i class="fab fa-github fa-fw"></i>GitHub</a>
      </span>
      <span class="links-of-author-item">
        <a href="mailto:sophimp2020@126.com" title="E-Mail → mailto:sophimp2020@126.com" rel="noopener" target="_blank"><i class="fa fa-envelope fa-fw"></i>E-Mail</a>
      </span>
  </div>



      </div>

    </div>
  </aside>
  <div id="sidebar-dimmer"></div>


      </div>
    </main>

    <footer class="footer">
      <div class="footer-inner">
        

        

<div class="copyright">
  
  &copy; 
  <span itemprop="copyrightYear">2021</span>
  <span class="with-love">
    <i class="fa fa-heart"></i>
  </span>
  <span class="author" itemprop="copyrightHolder">Sophimp</span>
</div>

<!--
  <div class="powered-by">Powered by <a href="https://hexo.io/" class="theme-link" rel="noopener" target="_blank">Hexo</a> & <a href="https://pisces.theme-next.org/" class="theme-link" rel="noopener" target="_blank">NexT.Pisces</a>
  </div>
-->

        
<div class="busuanzi-count">
  <script async src="https://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>
    <span class="post-meta-item" id="busuanzi_container_site_uv" style="display: none;">
      <span class="post-meta-item-icon">
        <i class="fa fa-user"></i>
      </span>
      <span class="site-uv" title="Total Visitors">
        <span id="busuanzi_value_site_uv"></span>
      </span>
    </span>
    <span class="post-meta-divider">|</span>
    <span class="post-meta-item" id="busuanzi_container_site_pv" style="display: none;">
      <span class="post-meta-item-icon">
        <i class="fa fa-eye"></i>
      </span>
      <span class="site-pv" title="Total Views">
        <span id="busuanzi_value_site_pv"></span>
      </span>
    </span>
</div>








      </div>
    </footer>
  </div>

  
  <script src="/lib/anime.min.js"></script>
  <script src="/lib/velocity/velocity.min.js"></script>
  <script src="/lib/velocity/velocity.ui.min.js"></script>

<script src="/js/utils.js"></script>

<script src="/js/motion.js"></script>


<script src="/js/schemes/pisces.js"></script>


<script src="/js/next-boot.js"></script>




  















  

  

</body>
</html>
